什麼是Markdown？

Markdown 是目前非常普遍用來撰寫文件的語言，有很多筆記軟體都支援 Markdown。它的目標就是「使用容易讀寫的純文字格式來編寫文件」，讓使用者可以專注在文字的本身，而不需要透過其它工具來切換格式 ( 雖然許多筆記軟體還是會提供格式化的按鍵和快捷鍵）。

除了筆記軟體外，我在學習程式語言時，也會使用 VS Code 來作筆記，當然要使用 Markdown 語法喔。另外，這裡我只說明 Markdown 在 VS Code 和 Jupyter Notebook 使用情況，並不探討其他 Markdown 延伸模組。

有關 Markdown 語法，請參考後面的傳送門，我不再重複說明。
另外，VS Code 也支援 HTML 的語法和 LaTex數學符號，對於作筆記有很多便利。

建議學習方式，可以新增一個 Markdown 檔案 .md自行抄寫 markdown 語法等，同時在另一側預覽比較。

Markdown 在 VS Code 編輯 / 預覽

如何在 VS Code 編輯 / 預覽 markdown 文件？

• markdown 的檔案格式是 .md ，
• 你可以在 VS Code 中打開或新增一個檔案，並將其儲存為 .md 檔案格式
• 當你在編輯 markdown 文件時，想要在右邊並列開啟預覽，可以按下快捷鍵 Ctrl+K V 或 點擊右上方的「在一側開啟預覽」按鍵。
• 另外想要開啟一新的預覽分頁，也可以按下快捷鍵  Ctrl+Shift+V ，或同時按下 Alt 鍵並點擊右上方的「在一側開啟預覽」按鍵。

如何在 VS Code 編輯 / 預覽 Jupyter Notebook 的 markdown 儲存格？

• 點選儲存格，左側的會顯示橘色線條。這儲存格的工具列通常會顯示在儲存格右上方。
• 如果儲存格在編輯模式 (edit mode)，點擊工具列的第一個按鍵，離開編輯模式，顯示預覽。也可以按下快捷鍵 Ctrl + Alt + Enter 或 Esc 鍵，停止編輯並顯示預覽。
• 如果儲存格在預覽狀況，按下快捷鍵 Enter 或滑鼠右鍵連點兩下，進入編輯模式。

Jupyter Notebook 的 儲存格 怎麼變矮？

點擊 左側的橘色線條，這個儲存格就會摺疊 (collapse) 成一行，或是展開恢復成原樣。
另外，也可以按下快捷鍵來摺疊/展開 儲存格：

• 快捷鍵
  Ctrl+0 Ctrl+0 ( 摺疊所有 輸入儲存格 )
  將所有的 Markdown儲存格 和 程式碼儲存格 摺疊
  Ctrl+0 Ctrl+9 ( 展開所有 輸入儲存格 )
  將所有的 Markdown儲存格 和 程式碼儲存格 展開

  Ctrl+K Ctrl+C ( 摺疊/展開 輸入儲存格 )
  將當前的Markdown儲存格 或 程式碼儲存格 摺疊/展開
  Ctrl+K T ( 摺疊/展開 輸出儲存格 )
  將當前的程式碼儲存格的輸出 摺疊/展開

Jupyter Notebook 的 儲存格 怎麼不見了？

Jupyter Notebook 是以類似網頁文件呈現，如同 Microsoft Word 般可以在標題處點擊來摺疊或展開文件的部分內容。

如果某個 Markdown儲存格 以 標題語法 (如: ### 標題3 ) 開始，當滑鼠移到這個儲存格，或這個儲存格已經被點選，在儲存格左邊外部有小三角形 (向下或向右) 的按鈕。

點擊這個按鈕，可以將以下所有儲存格一個接一個摺疊 (fold)收藏起來， 直到 另一 Markdown儲存格 以同階級或更高階的標題語法 (如: ## 標題2 ) 為止。
再點擊一次按鈕，可將收藏的儲存格展開。

也可以按下快捷鍵 向左 或 向右 來摺疊/展開 這儲存格以下的文件部分內容。

遇到疑難雜症怎麼辦？又要打怪物！

文章有點長了，這裡只講兩個在 VS Code 編寫 Markdown 時遇到的問題。

• 問題：在編輯模式，寫入3行文字。但在 VS Code 預覽時，卻連成 1行文字。
  快速解答：要完全符合Markdown語法，換行時，需在最後面加上兩個空格。

• 問題：Markdown語法不支援「可摺疊區塊」，而以標題語法摺疊部分內容又不適合我使用情況。
  快速解答：在Markdown文件中嵌入HTML元素來實現一些特殊的效果，如建立一個可摺疊的區塊。

<details>
  <summary>點選展開!</summary>

  1. 摺疊內容
  2. *斜體字*
      - **粗體字**
      - `強調`樣式
</details>

Markdown 傳送門

🌐 Markdown說明 -- iT 邦幫忙
🌐 Markdown Cheatsheet 中文版 - GitHub
🌐 Markdown 語法說明中文版 - GitHub